Skip to content

docs(all): make docs more coherent #387

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 27 commits into from
Jan 5, 2022
Merged

docs(all): make docs more coherent #387

merged 27 commits into from
Jan 5, 2022

Conversation

dreamorosi
Copy link
Contributor

@dreamorosi dreamorosi commented Jan 3, 2022

Description of your changes

This PR includes miscellaneous changes derived from early feedbacks & internal discussion.

Some changes include (but not limited to):

  • Fixed & checked all imports in examples
  • Fixed & checked all constructor initializations (i.e. Tracer -> new Tracer())
  • Changed order of example tabs to: Manual, Middy Middleware, Class constructors
  • Renamed all tabs that referenced "Middleware" to "Middy Middleware"
  • Included changes from docs(metrics): remove serializeMetrics and fix cloudwatch excerpt #376
  • Using newer LambdaInterface & async signature in examples

How to verify this change

Run docs locally npm run docs-runLocalDocker & head to http://localhost:8000

Related issues, RFCs

#372

PR status

Is this ready for review?: YES
Is it a breaking change?: NO

Checklist

  • My changes meet the tenets criteria
  • I have performed a self-review of my own code
  • I have commented my code where necessary, particularly in areas that should be flagged with a TODO, or hard-to-understand areas
  • I have made corresponding changes to the documentation
  • Any dependent changes have been merged and published in downstream module
  • The PR title follows the conventional commit semantics

Breaking change checklist

N/A


By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

@dreamorosi dreamorosi self-assigned this Jan 3, 2022
@dreamorosi dreamorosi added all documentation Improvements or additions to documentation labels Jan 3, 2022
@dreamorosi dreamorosi added this to the beta-release milestone Jan 3, 2022
@flochaz flochaz mentioned this pull request Jan 4, 2022
23 tasks
@dreamorosi dreamorosi requested review from saragerion, flochaz, heitorlessa and ijemmy and removed request for saragerion January 4, 2022 17:10
@dreamorosi dreamorosi marked this pull request as ready for review January 4, 2022 17:11
Copy link
Contributor

@saragerion saragerion left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great work! :D Just minor comments, but looking forward to merging this one

@dreamorosi dreamorosi requested a review from saragerion January 4, 2022 17:55
@dreamorosi
Copy link
Contributor Author

dreamorosi commented Jan 4, 2022

Great work! :D Just minor comments, but looking forward to merging this one

Thanks @saragerion, I've found&replaced all other occurrences to publishStoredMetrics in 482b6d8

saragerion
saragerion previously approved these changes Jan 4, 2022
flochaz
flochaz previously approved these changes Jan 5, 2022
ijemmy
ijemmy previously approved these changes Jan 5, 2022
Copy link
Contributor

@ijemmy ijemmy left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approve. I have some nit and minor comments. But I prefer to have this merged than getting things 100% perfect.

@dreamorosi Appreciate your effort on this. I can see that you really read through and caught all minor details.

@@ -74,7 +74,7 @@ For a **complete list** of supported environment variables, refer to [this secti
Environment:
Variables:
LOG_LEVEL: WARN
POWERTOOLS_SERVICE_NAME: shopping-cart-api
POWERTOOLS_SERVICE_NAME: serverlessAirline
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

(minor) There are a few more "shopping-cart-api" left in the doc.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

True, I've missed those. I've now removed all of the ones in the serviceName but left the ones in the function name

@logger.injectLambdaContext()
public handler() {
public async handler(_event: any, _context: any): Promise<void> {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice catch.

@dreamorosi dreamorosi dismissed stale reviews from ijemmy and flochaz via d982318 January 5, 2022 09:47
@dreamorosi dreamorosi merged commit a08bf76 into main Jan 5, 2022
@dreamorosi dreamorosi deleted the docs/general_improv branch January 5, 2022 09:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants